package com.ppch.wuwamanus.tools;

import org.springframework.ai.tool.annotation.Tool;
import org.springframework.ai.tool.annotation.ToolParam;

import java.util.Scanner;

/**
 * Package:ppch-ai-agent
 * ClassName:AskHumanTool
 *
 * @Author 泡泡茶壶
 * @Create 2025/8/1 20:09
 * @Version 1.0
 * Description:
 * 向人类寻求帮助的工具
 * TODO: 需要在IDEA中的Help->Edit Custom VM Options中添加这个配置-Deditable.java.test.console=true
 *       否则无法使用Scanner实现控制台输入字符串。
 */
public class AskHumanTool {

    /**
     * 向人类寻求帮助
     * @param inquire 你想问人类的问题
     * @return 人类的输入
     */
    @Tool(description = """
             如果你认为你需要从人类那里寻求帮助，或者你需要与用户进行对话，那么使用这个工具来询问用户。
            """)
    public String askHuman(@ToolParam(description = "你想问人类的问题。") String inquire){
        Scanner scanner = new Scanner(System.in);
        String userInput = scanner.nextLine().trim();
        // 关闭 Scanner
        scanner.close();
        return userInput;
    }

}
